home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _utilities / utilities / 003 / _arcmidi / !ArcMidi / !Help < prev    next >
Text File  |  1993-07-07  |  6KB  |  188 lines
  1. Note
  2. ====
  3.  
  4. This is a 'demo' version. The full version will include three editors:
  5. a keyeditor, a drum editor and a list editor. The full version will
  6. appear in august 1993.
  7.  
  8. Help for !ArcMidi (version 0.22)
  9. ================================
  10.  
  11. This version of ArcMidi is FREEware, and is
  12. Copyright ⌐ L.L. Frederiks 1993.
  13.  
  14. The Interface Manager module is FREEware, and is
  15. Copyright ⌐ SoftWare Interrupts Developments, 1991
  16.  
  17. The ArcMidi support module is FREEware, and is
  18. Copyright ⌐ F.K.W van de Pol 1993.
  19.  
  20. What IS ArcMidi
  21. ===============
  22.  
  23. ArcMidi is my attempt to write a MIDI sequencer. I started writing the
  24. program in May 1992. The first versions were written in BASIC and the time
  25. consuming routines appeared too slow. Therefore, in November 1993 I decided
  26. to rewrite the program using Acorn's Desktop C. It has been completely
  27. written using the famous RISCOS_Lib. Yes, J.W. it can be done....
  28.  
  29. ArcMidi uses Simon Huntinton's Interface Manager for displaying 3d icons
  30. and Frank van de Pol's ArcMidi support module.
  31.  
  32. ArcMidi should run on every machine and under every RISCOS version
  33. (2.0, 3.0, 3.1x). However, you need a MIDI podule and (of course) some
  34. MIDI instruments.
  35.  
  36. Instructions
  37. ============
  38.  
  39. Double-click the !ArcMidi icon to run the program. You should get an icon
  40. in the iconbar just like every other 'normal' RISCOS application.
  41.  
  42. MIDI files (format 0 and 1, for the insiders) can be loaded by dragging
  43. them to the iconbar icon. If the file type is unknown, ArcMidi will generate
  44. an error message.
  45.  
  46. Example data files
  47. ==================
  48.  
  49. Three example data files are supplied:
  50.  
  51. - Example2. A very short format 1 MIDI file. It just contains a few
  52.   notes.
  53.  
  54. - Vivaldi. A classical tune (format 1).
  55.  
  56. - BillyJean. A popsong from Michael Jackson.
  57.  
  58. The IconBar menu
  59. ================
  60.  
  61. Clicking MENU over the iconbar icon gives you a menu with the following
  62. items:
  63.  
  64. Info
  65.   As usual...
  66.  
  67. Show
  68.   Opens the 'show' window. The submenu gives access to the preferences,
  69.   control, tracks, counter and drum editor window. Clicking on the
  70.   menu option opens the window.
  71.  
  72. Clear
  73.   Not implemented yet. This option should clear all data.
  74.  
  75. Save
  76.   Opens a 'save as' box. The MIDI data is saved as a format 1 MIDI file.
  77.   Note: ArcMidi supports DragASprite under RISCOS 3.x !!!
  78.  
  79. Quit
  80.   er... quits.
  81.  
  82. Preferences
  83. ===========
  84.  
  85. This gives you access to the global preferences. The pane window contains
  86. four sections:
  87.  
  88. ArcMidi options
  89.   Controls the time representation in the counter window.
  90.   
  91.   Real - gives you hours/minutes/seconds/milli-seconds
  92.                representation.
  93.   SMPTE - gives you hours/minutes/seconds/frames/ticks
  94.                 representation.
  95.   Bar - gives you bars/notes/ticks representation. This is not yet
  96.         implemented.
  97.  
  98. MIDI Thru
  99.   Controls MIDI thru. It means that recorded MIDI data is transferred
  100.   to MIDI thru. If you use a master keyboard, it is ensured that you
  101.   hear what you are playing. You can turn this option on/off and you
  102.   can set the 'MIDI thru mapping'. Transparant means that the channels
  103.   of the MIDI events are not influenced. Otherwise, each recorded MIDI
  104.   event is send through the same MIDI channel.
  105.  
  106. MIDI Filter
  107.   Filters out the specified MIDI channel.
  108.  
  109. Sequence options
  110.   Sets the time signature and tempo (beats/minute). Not implemented yet.
  111.  
  112. The preferences window is closed by clicking on the OK icon. The save
  113. icon ensures that the settings are saved in a file (not implemented yet).
  114.  
  115. Control
  116. =======
  117.  
  118. The window gives you control over the sequencer. The buttons just work
  119. like any other tape-recorder.
  120.  
  121. Tracks
  122. ======
  123.  
  124. In this window you can set which track is used for recording and which
  125. track is on during play back. You can also set the MIDI channel for each
  126. track. By pressing MENU in this window, you can open two further windows:
  127.  
  128. Comment
  129.   This window enables you to type a comment for each track
  130.  
  131. Statistics
  132.   Gives you information about each track: the number of events, the
  133.   start and stop time, the MIDI channels.
  134.  
  135. Counter
  136. =======
  137.  
  138. This window is used for displaying the time information. The upper icon
  139. is used for displaying SMPTE time, the lower icon is used for displaying
  140. 'real time'. Note: sometimes the counter will take up too much 'desktop'
  141. bandwidth. This could cause incorrect playing of the MIDI data.
  142.  
  143. Drum editor
  144. ===========
  145.  
  146. Not ready yet (although you play around with it).
  147.  
  148. Conditions of Use
  149. =================
  150.  
  151. 1. This software remains the copyright of the author, L.L. Frederiks, but it
  152.    may be freely distributed and used, provided that:
  153.    a) it is kept as a whole- All files associated with the application must
  154.       be included in their original form, especially THIS one.
  155.    b) no charge is made for any copying or distribution other than third
  156.       party transmission costs (eg disc purchase cost, postage, phone
  157.       charges).
  158.    c) Any profits should be donated to a registered charity.
  159.  
  160. 2. The software may not be distributed with or as part of any other product
  161.    for which a charge (other than a third party charge as (1) above) is
  162.    made, without prior permission of the author.
  163.  
  164. 3. The author does not accept any responsibility for any use or misuse of
  165.    the software or any consequences thereof.
  166.  
  167. I would prefer that anyone wishing to distribute this (or any other) item of
  168. software that I have written, please contact me first. This way, I can
  169. assure you that you are not breaking the law (As many people are doing with
  170. my non-free software), and I will quite possibly have a newer version of the
  171. software that I will be quite willing to post back to you. I am already
  172. getting sick of people using my software for profit without my permission,
  173. and I will simply stop releasing my software AT ALL if this continues.
  174.  
  175. =============================================================================
  176.  
  177. Any feedback, including bug reports, would be appreciated.
  178. Contact me at the following addresses:
  179.  
  180. SnailMail: L.L. Frederiks
  181.            Runmolen 88A 
  182.            1823 GM Alkmaar
  183.            The Netherlands
  184.  
  185. email:     loek@nt.el.utwente.nl (until April 1994)
  186.  
  187. or just post a message to UseNet's comp.sys.acorn newsgroup.
  188.